Quick Reference for vi 


This quick reference lists commands you can use in the vi editor 
on Hewlett-Packard’s UNIX™ System, HP-UX. 


Notations 


• Commands beginning with : (colon) must end with [ Return | 
These commands represent escape commands to the ex 
editor. You can reference the ex tutorial for more details. 

• file is the name of file 

• cursor_cmd is a cursor movement command 
(e.g., G j w b) 

• char is a single character 

• str is a character string (can contain pattern matching char¬ 
acters) 

• | ctrl H~>n means you press | ctrl | , hold it down, and press 
the [7] key. 

• n,m can be two line numbers (e.g., 4.50), line marker (e.g., 
. , $), or search expression (e.g., /stringl/, /string2/). 

• (a-z) means you choose a letter from a through z 


Modes 


Command Mode 


Insert Mode 


When you are not inserting or changing text, 
you can move the cursor and run commands 
(e.g., searching, deleting, saving). Pay atten¬ 
tion to the case of the commands; check the 
I caps I lock key if vi behaves strangely. 

When you insert or change more than one 
character of text, you cannot use command 
mode commands. To leave the insert mode, 
press I esc | . 
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* UNIX™ is a trademark of AT&T Bell Laboratories. 
Copyright 1987, Hewlett-Packard Company. 
Copyright 1980, 1984, AT&T, Inc. 




























Start a vi Session 

vi file 

Edit file 

vi -rj file 

Edit last saved version of file after system or 
editor crash 

vi + n file 

Edit file and place cursor at line n 

vi + file 

Edit file and place cursor on last line 

vi file1 file2 . 

.filer) Edit file1 through filerr, After saving changes 
in filel , enter :n for next file 

vi +/str file 

Edit file and place cursor at line containing str 


Save Text and Exit vi 


ZZ or : wq or : x Save file and exit vi 

:w file Save file but do not exit; omitting file saves 


: w! file 

current file 

Save file overriding normal checking 

:n,mvi file 

Write lines n through m to file 

: n,mvi>>file 

Append lines n through m to end of file 

:q 

Leave vi, saving changes before last write 
(you may be prompted to save first) 

: q! 

Leave vi without saving any changes since 
last write 

Q 

Escape vi into ex editor with same file; : vi 
returns. 

: e! 

Re-edit current file, disregarding changes since 
last write 

Status Commands 

rcTRL>m 

Print current line number 

Print number of lines in file 

Show file name, current line number, total lines 
in file, and percent of file location 

: 1 (letter “1”) 

Display tab (~1) backslash (\) backspace (~H) 
newline ($) bell (~G) formfeed (~L) of current 
line in status line 















Inserting Text 

To leave the insert mode, press | esc | . 

a Append after cursor 

A Append after end of current line 

i Insert before cursor 

I Insert before beginning of current line 

o Open new line below current line and insert 

0 Open new line above current line and insert 

I Ctrl H~n char While inserting, ignore special meaning of char 
(e.g., for inserting characters like I esc I and 
control characters) 

: r file Read file , and insert after current line 

: nr file Read file, and insert after line n 



Undoing and Repeating Commands 


u 


Undo last command 


U 

"np 

" lpu.u. 


n 

N 


Restore current line to original state 

Retrieve last nth delete (last 9 deletes are in a 
buffer) 

Scroll through the delete buffer until you retrieve 
desired delete (repeat u.) 

Repeat last / or ? search command 

Repeat, in reverse direction, last / or ? search 
command 


; (semi-colon) Repeat last f F t or T search command 

, (comma) Repeat, in reverse direction, last f F t or T 

search command 


. (period) 


Repeat last text change command 

























Moving the Cursor 


k or | CTRL H~P~| 

j or | CTRL H T1 
or |CTRL H n | 

h or I CTRL M~h~1 
or | Back space] 

1 or Space 

w or W 
b or B 
e or E 
0 (zero) or | 

rj | 

“ (caret) 

$ 

+ Or | Return 1 

1G 

G 

G$ 

nG 

( 

) 

{ 

> 


Up 

Down 

Left 

Right 

Start of next word; W ignores punctuation 

Start of previous word; B ignores punctuation 

End of next word; E ignores punctuation 

First column in current line 

Column n in current line 

First non-blank character in current line 

Last character in current line 

First character in next line 

First non-blank character in previous line 

First line in file 

Last line in file 

Last character in file 

Line n in file 

Back to beginning of sentence 
Forward to beginning of next sentence 
Back to beginning of paragraph 
Forward to beginning of next paragraph 



Mark sections by placing { in first column. 

[ [ Back to beginning of section 

] ] Forward to beginning of next section 































Deleting Text 

I CTRL hOH or 

1 Back space I 

While inserting, delete previous character 

I CTRL H w | 

While inserting, delete previous word 

rCTRL}fin 

While inserting, delete to start of inserted text 

nx 

Delete n characters beginning with current; omit¬ 
ting n deletes current character 

nX 

Delete previous n characters; omitting n deletes 
previous character 

xp 

Switch character at cursor with following character 

ndw 

Delete next n words beginning with current; omit¬ 
ting n deletes current word 

ndb 

Delete previous n words; omitting n deletes previ¬ 
ous word 

ndd 

Delete n lines beginning with current; omitting n 
deletes current line 

:n,md 

Delete lines n through m 

D or d$ 

Delete from cursor to end of current line 

d cursor_cmd 

Delete text to cursor_cmd (e.g., dG deletes from 
current line to end of file) 


db Delete word 

D or d$ Delete to 
end of line 

,-a-^ 


before cursor 

,-A- 

dw Delete word 


Deleting 

text in a file.} dd 

Delete 

j 

t\ 

line 

X Delete Cursor x Delete 


character 

character 


before cursor 

at cursor 



Placing Marks in the Text 


m(a-z) 

Mark current position with a letter a through z 
(e.g., ma) 

’ (a-z) 

Move cursor to position (a-z) (e.g., ’a) 

" or * * 

Move cursor to location before last / ? or G 

(single quotes or 

command 


grave accents) 

























Pattern Matching 

Pattern matching characters help find strings with similar charac¬ 
teristics. 

:set magic 

Allow pattern matching with special characters 
(default) X 

:set nomagic 

Allow only * and $ as special characters 

“ (caret) 

Match beginning of line 

$ 

Match end of line 

• 

Match any single character 

\< 

Match beginning of word 

\> 

Match end of word 

[sfr] 

Match any single character in str 

[~sfr] 

Match any character not in str 

Ca-n] 

Match any character between a and n 

* 

Match zero or more occurrences of previous 
character in expression 

\ 

Escape meaning of next character (e.g., \$ lets 
you search for $) 

\\ 

Escape the \ character 


Indenting Text 


I CTRL hTD Or [Tab] 

While inserting, insert one shift width 

:set ai 

Turn on auto-indentation 

:set sw=n 

Set shift width to n characters 

n« or n» 

Shift n lines left or right (respectively) by one 
shift width; omitting n shifts one line 

< or > 

Use with cursor command to shift multiple lines 
left or right 
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Searching 


•/. 

Search to beginning of balancing ( ) [ ] or { > 

ichar 

Search forward in current line to char 

F charge 

Search backward in current line to char 

t char 

Search forward in current line to character before 

char 

T char 

Search backward in current line to character after 

char 

/Str | Return | 

Find str . 

?str | Return | 

Search in reverse for str 

:set ic 

Ignore case when searching 

:set noic 

Pay attention to case when searching (default) 


Global Search and Replace 


:n,ms/strl /str2/opt Search from n to m for strl. Replace strl 

with str2, using opt. opt can be g for global 
change, c to confirm change (press y to 
acknowledge, I Return | to suppress), and p 
to print changed lines. 


& 

: g / st r/cmd 
: g/strl/s/str2/str3/ 


Repeat last : s command 

Run cmd on all lines that contain str 

Find line containing strl, replace str2 with 
str3 


: v/str/cmd 


Execute cmd on all lines that do not match 

str 


Copying and Placing Text 


nyy or nY 


Yank n lines (place in buffer); omitting n yanks 
current line 


y cursor_cmd 

"(a-z)nyy or 
"(a-z)ndd. 

p (lower-case) 
P 


Yank from cursor to cursor_cmd (e.g., yG yanks 
current line to last line in file) 

Copy or delete n lines into named buffer a 
through z; omit n for current line 

Put yanked text after cursor (print buffer); also 
prints last deleted text 

Put yanked text before cursor; also prints last 
deleted text 


"(a-zjp or "(a-zJP Put lines from named buffer a through z after 
or before current line 

A s 

















Changing Text 

Preceding these commands with n (a number) repeats the com¬ 
mand n times. 

rchar 

Replace current character with char 

R text | esc | 

Replace current character(s) with text 

stext | esc| 

Substitute text for current character 

S or cc text | esc 

) Substitute text for entire line 

cwfexf | esc | 

Change current word to text 

C text | esc | 

Change rest of current line to text 

c cursor_cmd text | 

esc | Change to text from current position to 

cursor _cmd 


Joining Lines 

J Join next line to end of current line 

nJ Join next n lines 


Cursor Placement 
and Adjusting the Screen 


H 

Move cursor to top line of screen 

nH 

Move cursor to line n from top of screen 

M 

Move cursor to middle of screen 

L 

Move cursor to bottom line of screen 

nL 

Move cursor to Line n from bottom of screen 

rcTRL>fn 

Move screen up one line 

rcTRL>m 

Move screen down one line 

rcTRLjfiri 

Move screen up V 2 page 

rcTRLi{^n 

Move screen down V 2 page 

rCTRLlTbl 

Move screen up one page 

rcTRurm 

Move screen down one page 

I ctrl HT1 (letter “1”) 

Redraw screen 

Z | Return | 

Make current line top line on screen 

HZ | Return | 

Make line n top line on screen 

Z. 

Make current line middle line 

nz. 

Make line n middle line on screen 

z- 

Make current line bottom line 

nz- 

Make line n bottom line on screen 












































Shell Escape Commands 

- 1 _ 


: ! cmd Execute shell command cmd; you can add 

these special characters to indicate: 

'/. name of the current file 
# name of last file edited 

:! ! Execute last shell command 

: r! cmd Read and insert output from cmd 

: f file Rename current file to file 

: w ! cmd Send currently edited file to cmd as standard 

input and execute cmd 

: cd dir Change the current working directory to dir 

($H0ME is default) 

: sh Start a sub-shell (I ctrl t - TT) returns to editor) 

: so file Read and execute commands in file (file is a 

shell script) 


Shell Filters 


! cursor_cmd cmd Send text from current position to cursor_cmd 
to shell command cmd. Replace original text 
in file with output from cmd 

! }sort | Return I Example: Sort from current position to end of 
paragraph and replace text with sorted text 


Macros and Abbreviations 


: map key cmd_seq 

:map 

: unmap key 
: ab str string 

: ab 

:una str 


Define key to run cmd_seq when pressed 
Display all created macros on status line 
Remove macro definition for key 
When str is inserted, replace with string 
Display all abbreviations 
Unabbreviate str 


Map allows you to define strings of vi commands. Place in 
.exrc to run each time you enter vi. For long macros, set the 
notimeout option. If you embed control characters (e.g., keys 
like | esc |) in the macro, you need to precede them with | ctrl K~71 . 
If you need to include quotes ("), precede them with \ (backslash). 
Unused keys in vi are: K V g q v * = and the function keys. 

Example: 

:map v /I [ ctrl H~D I esc I dwiYou fcTRL~H~v~l [esc] (esc] 
When v is pressed, search for “I” (/I fisc]) , delete word (dw) and 
insert “You” (iYou [esc]). | ctrl H~v~| allows | esc [ to be inserted. 



































Setting Options 


Options shown here are default. To change them, either set them 
(:set option) or unset them (: set nooption). To run options each 
time you enter vi, place in . exrc file in home directory and omit 


preceding colons (:). 


:set all 

Print all options 

:set no option 

Turn off option 

:set noai 

Set automatic indentation 

:set ap 

Print line after d c J m : s t u command 

:set bf 

Discard control characters from input 

:set eb 

Precede error messages with bell 

:set noic 

Ignore case when searching 

:set dir=tmp 

Set directory of buffer file 

:set lisp 

Modify brackets for Lisp compatibility 

iset magic 

Pattern match with special characters 

:set mesg 

Allow other users to send messages 

:set nolist 

Show tabs (“1) and end of line ($) 

:set nonu 

Prefix lines with line number 

:set opt 

Speed output: eliminate automatic I Return I 

:set prompt 

Prompt for command mode input with : 

:set nore 

Simulate smart terminal on dumb terminal 

:set remap 

Allow macros within macros 

:set noreport 

Indicate largest size of changes reported on 
status line 

:set ro 

Change file to read only 

:set scroll=n 

Set n lines for | Ctrl HTI and z 


set sh =shell_path Set shell escape (default is /bin/sh) 


:set showmode 

Indicate input or replace mode 

iset sw=8 

Set the shift width 

:set term 

Print terminal type 

:set noterse 

Shorten error messages with terse 

iset notimeout 

Eliminate one second time limit for macros 

:set tl=0 

Set significance of tags beyond this many 
characters (0 means all) 

:set ts=8 

Set tab stops for text input 

:set nowa 

Inhibit normal checks before write com¬ 
mands 

iset warn 

Warn “No write since last change" 

: set window=n 

Set number of lines in a text window 

:set wm=n 

Set automatic wraparound n spaces from 
right margin (e.g., : set wm=8) 









